home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat3 / PMAPI / pmlookupname.z / pmlookupname
Text File  |  1997-04-03  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMLLLLOOOOOOOOKKKKUUUUPPPPNNNNAAAAMMMMEEEE((((3333))))                                                PPPPMMMMLLLLOOOOOOOOKKKKUUUUPPPPNNNNAAAAMMMMEEEE((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmLLLLooooooookkkkuuuuppppNNNNaaaammmmeeee - translate performance metric names into PMIDs
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ppppccccpppp////ppppmmmmaaaappppiiii....hhhh>>>>
  13.  
  14.      iiiinnnntttt ppppmmmmLLLLooooooookkkkuuuuppppNNNNaaaammmmeeee((((iiiinnnntttt nnnnuuuummmmppppmmmmiiiidddd,,,, cccchhhhaaaarrrr ****nnnnaaaammmmeeeelllliiiisssstttt[[[[]]]],,,, ppppmmmmIIIIDDDD ppppmmmmiiiiddddlllliiiisssstttt[[[[]]]]))))
  15.  
  16.      cccccccc ............ ----llllppppccccpppp
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      Given a list in _n_a_m_e_l_i_s_t containing _n_u_m_p_m_i_d full pathnames for
  20.      performance metrics from a Performance Metrics Name Space (PMNS),
  21.      ppppmmmmLLLLooooooookkkkuuuuppppNNNNaaaammmmeeee returns the list of associated Performance Metric IDs
  22.      (PMIDs) via _p_m_i_d_l_i_s_t.
  23.  
  24.      The result from ppppmmmmLLLLooooooookkkkuuuuppppNNNNaaaammmmeeee will be the number of names translated in
  25.      the absence of errors, else an error code less than zero.  When errors
  26.      are encountered, the corresponding value in _p_m_i_d_l_i_s_t will be PM_ID_NULL.
  27.  
  28.      Note that the error protocol guarantees there is a 1:1 relationship
  29.      between the elements of _n_a_m_e_l_i_s_t and _p_m_i_d_l_i_s_t, hence both lists contain
  30.      exactly _n_u_m_p_m_i_d elements.  For this reason, the caller is expected to
  31.      have pre-allocated a suitably sized array for _p_m_i_d_l_i_s_t .
  32.  
  33. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  34.      ppppmmmmLLLLooooaaaaddddNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3) and ppppmmmmNNNNaaaammmmeeeeIIIIDDDD(3).
  35.  
  36. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  37.      PPPPMMMM____EEEERRRRRRRR____TTTTOOOOOOOOSSSSMMMMAAAALLLLLLLL
  38.           _n_u_m_p_m_i_d must be at least 1
  39.  
  40.      PPPPMMMM____EEEERRRRRRRR____NNNNOOOOPPPPMMMMNNNNSSSS
  41.           A PMNS must have been loaded with ppppmmmmLLLLooooaaaaddddNNNNaaaammmmeeeeSSSSppppaaaacccceeee(3) before calling
  42.           ppppmmmmLLLLooooooookkkkuuuuppppNNNNaaaammmmeeee.
  43.  
  44.      PPPPMMMM____EEEERRRRRRRR____NNNNAAAAMMMMEEEE
  45.           One or more of the elements of _n_a_m_e_l_i_s_t does not correspond to a
  46.           valid metric name in the PMNS.
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.